home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.1
/
xftp.1
< prev
next >
Wrap
Text File
|
1995-07-25
|
59KB
|
1,453 lines
xftp(1) USER COMMANDS xftp(1)
NAME
LLNL XFTP - an X-based interface to FTP
SYNOPSIS
xftp [standard X options]
DESCRIPTION
_L_L_N_L _X_F_T_P is a graphical user interface to FTP (File
Transfer Protocol). _L_L_N_L _X_F_T_P does not execute the _f_t_p pro-
gram; instead, it directly communicates with remote FTP
servers. _L_L_N_L _X_F_T_P is an X client and follows the OSF/Motif
look-and-feel. _L_L_N_L _X_F_T_P enables users to transfer files
and perform various directory manipulation commands, both
remotely and locally. Two especially notable features are
the ability to (1) perform "third-party" file transfers, and
(2) transfer or delete entire directory substructures.
_L_L_N_L _X_F_T_P'_s main window is divided into five main sections:
(1) the main menu bar at the top of the window, (2) the
diagnostics log at the bottom, (3) the file transfer con-
trols in the center, and (4 and 5) the "left" and "right"
host sections to either side of the file transfer controls.
_L_L_N_L _X_F_T_P can be connected to zero, one, or two hosts. The
hosts may be any combination of local and remote hosts (the
local host is the client host upon which _L_L_N_L _X_F_T_P is run-
ning). In this document, a connected host is referred to as
either the "left" or "right" host, depending on whether it
is displayed in the left or right host section, respec-
tively.
Each host section consists of four major graphical elements:
(1) a label which displays the host's name; (2) a menu bar
whose menus contain many commands that operate on the host;
(3) a "directory" menu; and (4) a scrollable "directory
list."
Each host's _C_o_n_n_e_c_t menu contains commands for
connecting/disconnecting local and remote hosts.
Each host's _D_i_r menu contains various commands for creating
new directories, and for changing and displaying the current
directory.
Each host's _S_e_l_e_c_t menu contains commands for
selecting/deselecting entries in the current directory (the
selections appear in the scrollable list of directory
entries).
Each host's _O_p_s menu contains several commands that operate
Last change: 12 May 1994 1
xftp(1) USER COMMANDS xftp(1)
on selected directory entries.
Each host's directory menu contains each link of the path of
the current directory (the last link is displayed). By
selecting a link in the path, the current directory is
correspondingly changed. (Hence, this is a mechanism to
traverse up the host's directory structure.)
Each host's directory list contains the entries of the
current directory. One way to select/deselect a directory
entry is to click on it. If an entry is double-clicked, an
attempt is made to change the current directory to that
entry. (Hence, this is a way to traverse down the host's
directory structure.)
The file transfer controls in the middle of the main window
allow the user to initiate file transfers on selected
entries. The transfers can go from left to right or from
right to left. Angle brackets in the _C_o_p_y and _R_c_o_p_y buttons
indicate the direction of the transfer (e.g., ">>Copy>>"
indicates that a left-to-right transfer would take place).
The _V_i_e_w button causes the selected file to be displayed.
The scrollable diagnostics log window at the bottom of the
main window displays error and status information. The user
can control the level of verbosity of messages written to
this window via the user preference _D_i_a_g_n_o_s_t_i_c_s. The con-
tents of this window can be saved to a file by selecting the
_S_a_v_e _L_o_g item in the _L_o_g menu. The diagnostics window can
be cleared by selecting the _C_l_e_a_r _L_o_g item in the _L_o_g menu.
There is a flag to the left of the diagnostics log window
that indicates whether an operation completes successfully
or not. If an operation fails then (1) a beep is emitted,
(2) the flag changes from green to red (white to black on
monochrome displays), (3) the "OK" in the flag changes to
"E", and (4) an error message is written to the diagnostic
log window. The next operation will clear the error flag.
_L_L_N_L _X_F_T_P automatically caches (1) wildcard expressions, (2)
paths of current directories, (3) host names and user names
used in connecting to remote hosts, and (4) quoted commands.
The purpose of each cache is to reduce the amount of typing
required. For example, when the user wishes to apply a
wildcard expression to select directory entries, a list of
recently referenced wildcard expressions for that host will
be presented to the user; the user can then double-click on
an existing wildcard expression to apply it. The cache is
automatically preserved across _L_L_N_L _X_F_T_P sessions in a file
named ".xftpcache" in the users home directory.
Last change: 12 May 1994 2
xftp(1) USER COMMANDS xftp(1)
GETTING STARTED
Use the _C_o_n_n_e_c_t menus to connect the two sides to the
desired combination of local and/or remote hosts. (Depend-
ing on how the user preferences are set, when _L_L_N_L _X_F_T_P
comes up some combination of the left and right sides might
already be connected to the local host.)
Once connected, traverse through a host's directory struc-
ture by (1) using the directory name menu (the menu just
above the directory list), (2) double-clicking on entries in
the directory list, (3) selecting an item in the _G_o _t_o _P_r_e_-
_v_i_o_u_s _D_i_r_e_c_t_o_r_y submenu in the host's _D_i_r menu, or (4)
selecting the _C_h_a_n_g_e _D_i_r_e_c_t_o_r_y item in the host's _D_i_r menu.
Obtain different types of views into a host's current direc-
tory by selecting the _D_i_s_p_l_a_y _D_i_r_e_c_t_o_r_y (_L_o_n_g) or _D_i_s_p_l_a_y
_D_i_r_e_c_t_o_r_y (_T_a_b_l_e) items in the host's _D_i_r menu.
Select/deselect directory entries to operate on by (1)
single-clicking on entries in the main directory list, (2)
single-clicking on entries in the tabular directory list,
(3) dragging the mouse with the left button held down over
entries in the tabular directory list, or (4) by selecting
any of the items in the host's _S_e_l_e_c_t menu.
Transfer selected items by clicking on the _C_o_p_y or _R_c_o_p_y
(recursive copy) buttons. Be sure to first set the file
transfer mode by toggling the appropriate button (_A_S_C_I_I or
_B_i_n_a_r_y) in the main window.
View a selected file by clicking on the _V_i_e_w button. Con-
figure the viewer by selecting item _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s in
the _O_p_t_i_o_n_s menu. Be sure to first set the file transfer
mode by toggling the appropriate button (_A_S_C_I_I or _B_i_n_a_r_y) in
the main window.
Perform other types of operations on selected items by
selecting any one of the items in the host's _O_p_s menu.
Configure _L_L_N_L _X_F_T_P by selecting the _P_r_e_f_e_r_e_n_c_e_s item in the
_O_p_t_i_o_n_s menu.
COMMANDS
_L_L_N_L _X_F_T_P contains a large number of commands. The commands
are found in (1) the main menus, (2) the host menus, and (3)
in the _X_f_e_r _O_p_s controls. Here is a list of the commands:
About LLNL XFTP (in _F_i_l_e menu)
Gives version information.
Change Directory (in _D_i_r menus)
Change the current directory. A dialog pops up to
Last change: 12 May 1994 3
xftp(1) USER COMMANDS xftp(1)
prompt for the directory to change to. The directory
may be specified with a full or relative path. Previ-
ously referenced directories are cached and displayed
in a scrollable list. Double-click on a path in the
list to change to that directory. Single click on a
path in the list to place that entry into the text
field labeled "Directory:", where it can be edited.
Click on the _O_K button to change to the directory
displayed in the text field. (See user preferences _A_d_d
_t_o _C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _D_i_r_e_c_t_o_r_y _C_a_c_h_e _S_i_z_e, _H_o_s_t _C_a_c_h_e
_S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.)
Clear Log (in _L_o_g menu)
Clear the diagnostics log window.
Connect to Anonymous (in _C_o_n_n_e_c_t menus)
Easily connect to an anonymous FTP site. If currently
connected, the connection is first closed. A dialog
pops up to prompt for the remote host, user name and
password. The user name is initialized to "anonymous".
The password is initialized to the value of the user
preference _A_n_o_n_y_m_o_u_s _F_t_p _P_a_s_s_w_o_r_d (which you will prob-
ably want to set to your email address). An optional
port number may follow the host name (using a space as
the delimiter). Previously used host/user name pairs
are cached, and those with user names "anonymous" or
"ftp" are displayed in a scolled list labeled "Recently
Referenced Hosts:". Double-clicking on a host/user
name pair initiates a connection. Single-clicking on a
host/user name pair places those values in to the host
name and user name fields, where they can be edited.
Click on the _C_o_n_n_e_c_t button to initiate a connection.
(See user preferences _A_d_d _T_o _C_a_c_h_e, _A_n_o_n_y_m_o_u_s _F_t_p _P_a_s_s_-
_w_o_r_d, _D_i_a_g_n_o_s_t_i_c_s, _H_o_s_t _C_a_c_h_e _S_i_z_e, _U_s_e_r _C_a_c_h_e _S_i_z_e,
and _S_o_r_t _C_a_c_h_e_s.)
Connect to Local (in _C_o_n_n_e_c_t menus)
Connect to the local (client) host. If currently con-
nected, the connection is first closed. (See user
preferences _L_e_f_t _A_u_t_o _L_o_c_a_l _L_o_g_i_n and _R_i_g_h_t _A_u_t_o _L_o_c_a_l
_L_o_g_i_n.)
Connect to Remote (in _C_o_n_n_e_c_t menus)
Connect to a remote host (use _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s to
more easily connect to an anonymous FTP site). If
currently connected, the connection is first closed. A
dialog pops up to prompt for the remote host and user
names. The user name is initialized to the value of the
environment variable _U_S_E_R. An optional port number may
follow the host name (using a space as the delimiter).
Previously used host/user name pairs are cached and
those with user names other than "anonymous" and "ftp"
Last change: 12 May 1994 4
xftp(1) USER COMMANDS xftp(1)
displayed in a scolled list labeled "Recently Refer-
enced Hosts:". Double-clicking on a host/user name
pair initiates a connection. Single-clicking on a
host/user name pair places those values into the host
name and user name fields, where they can be edited.
Click on the _C_o_n_n_e_c_t button to initiate a connection.
(See user preferences _A_d_d _T_o _C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _H_o_s_t
_C_a_c_h_e _S_i_z_e, _U_s_e_r _C_a_c_h_e _S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.)
Contextual Help (in _H_e_l_p menu)
Enter contextual-help mode. The mouse cursor changes
to a pointing hand. Move the hand and click on any
graphical element in the main window that you wish to
know more about.
Copy (in _X_f_e_r _O_p_s controls)
Transfers the selected files according to the mode
(_A_S_C_I_I or _B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. A dialog
pops up to enable the user to monitor the progress of
the transfers. The dialog contains a button for abort-
ing the transfers. (See user preferences _B_e_e_p _W_h_e_n _O_p_s
_D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, _I_n_i_t_i_a_l _T_r_a_n_s_f_e_r _M_o_d_e, and _I_n_q_u_i_r_e
_O_n _C_o_p_y.)
Delete Selected Entry(s) (in _O_p_s menus)
Deletes the selected entries. A dialog pops up to
enable the user to monitor the progress of the dele-
tions. The dialog contains a button for aborting the
deletions. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e,
_D_i_a_g_n_o_s_t_i_c_s, and _I_n_q_u_i_r_e _O_n _D_e_l_e_t_e.)
Deselect All Entries (in _S_e_l_e_c_t menus)
Deselect all the entries in the host's current direc-
tory.
Disconnect (in _C_o_n_n_e_c_t menus)
Close the currently connected host. (See user prefer-
ence _D_i_a_g_n_o_s_t_i_c_s.)
Display Directory (Long) (in _D_i_r menus)
Pops up a dialog that displays the contents of the
current directory in a scrollable list. If supported
by the host (and this is almost always the case), addi-
tional information about each directory entry is
displayed, such as file length and access restrictions.
This display is automatically updated as the current
directory changes. This directory display does not
support selecting entries or displaying the current
selection. _W_a_r_n_i_n_g: Using this feature can increase
network traffic, put an additional load on the remote
host, and slow down interactivity. (See user prefer-
ence _D_i_a_g_n_o_s_t_i_c_s and _S_o_r_t _L_o_n_g _L_i_s_t_s _B_y _D_a_t_e.)
Last change: 12 May 1994 5
xftp(1) USER COMMANDS xftp(1)
Display Directory Path (in _D_i_r menus)
Pops up a dialog that displays the current directory
for that host. It will be automatically updated as the
current directory changes. (See user preference _D_i_a_g_-
_n_o_s_t_i_c_s.)
Display Directory (Table) (in _D_i_r menus)
Pops up a dialog that displays the contents of the
current directory in tabular form. This dialog may be
used to view and modify the directory's selected
entries. Entries may be selected/deselected either by
clicking or by moving the cursor over the entries with
the mouse button down. Moving the mouse too quickly
can cause some of the entries to be skipped. If an
entry is double-clicked, an attempt is made to change
the current directory to that entry. This display is
automatically updated as the current directory changes.
(See user preference _D_i_a_g_n_o_s_t_i_c_s.)
Getting Started (in _H_e_l_p menu)
Describes how to get started using _L_L_N_L _X_F_T_P.
Go to Previous Directory (in _D_i_r menus)
Displays a pullright menu that allows the user to
easily change the current directory to a previously
referenced directory. (See user preferences _A_d_d _t_o
_C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _D_i_r_e_c_t_o_r_y _C_a_c_h_e _S_i_z_e, _H_o_s_t _C_a_c_h_e
_S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.)
LLNL XFTP Overview (in _H_e_l_p menu)
Gives a high-level description of _L_L_N_L _X_F_T_P.
Make Directory (in _D_i_r menus)
Pops up a dialog to prompt for the name of a directory
to make in the current directory. The user preference
_E_n_t_e_r _D_i_r _U_p_o_n _C_r_e_a_t_i_o_n controls whether the the newly
created directory is automatically entered upon crea-
tion. (See user preferences _D_i_a_g_n_o_s_t_i_c_s and _E_n_t_e_r _D_i_r
_U_p_o_n _C_r_e_a_t_i_o_n.)
Move Selected Entry(s) (in _O_p_s menus)
Move selected entries from the current directory to
another directory on the same host. This is similar to
the UNIX _m_v command, but without rename capability.
(See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, and _D_i_a_g_n_o_s_-
_t_i_c_s.)
Preferences (in _O_p_t_i_o_n_s menu)
Display the user preferences dialog. See _U_S_E_R _P_R_E_F_E_R_-
_E_N_C_E_S section for a description of user preferences.
Quit (in _F_i_l_e menu)
Last change: 12 May 1994 6
xftp(1) USER COMMANDS xftp(1)
Terminate _L_L_N_L _X_F_T_P.
Rcopy (in _X_f_e_r _O_p_s controls)
Recursively transfers the selected entries according to
the mode (_A_S_C_I_I or _B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. If
a selected entry is a directory, an attempt is made to
transfer its entire directory subtree. A dialog pops
up to enable the user to monitor the progress of the
transfers. The dialog contains a button for aborting
the transfers. (See user preferences _B_e_e_p _W_h_e_n _O_p_s
_D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, _I_n_i_t_i_a_l _X_f_e_r _M_o_d_e, and _I_n_q_u_i_r_e _O_n
_C_o_p_y.)
Recursively Delete Selected Entry(s) (in _O_p_s menus)
Recursively deletes the selected entries. A dialog
pops up to enable the user to monitor the progress of
the deletions. The dialog contains a button for abort-
ing the deletions. _W_a_r_n_i_n_g: Exercise extreme caution
when using this command because it deletes entire
directory subtrees. To minimize the chance of an unin-
tentional deletion, this menu item is greyed out unless
the user preference _R_e_c_u_r_s_i_v_e _D_e_l_e_t_e _E_n_a_b_l_e_d is
enabled. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e,
_D_i_a_g_n_o_s_t_i_c_s, _I_n_q_u_i_r_e _O_n _D_e_l_e_t_e, and _R_e_c_u_r_s_i_v_e _D_e_l_e_t_e
_E_n_a_b_l_e_d.)
Rename Selected Entry(s) (in _O_p_s menus)
Pop up a dialog to individually rename selected
entries. This is similar to the UNIX _m_v command except
that the renamed entries cannot be moved to another
directory. (See user preference _D_i_a_g_n_o_s_t_i_c_s.)
Save Log (in _L_o_g menu)
Write the contents of the diagnostics window to a
user-specified file. The existing contents of the
diagnostics window are not removed.
Save Preferences (in _O_p_t_i_o_n_s menu)
Save the current settings of the user and viewer
preferences.
Select All Entries (in _S_e_l_e_c_t menus)
Select all the entries in the host's current directory.
Send Quoted Command (in _O_p_s menus)
Pops up a dialog to prompt for a "raw" command to send
to the FTP server of the remote host. Previously
issued commands are cached and displayed in a scrolled
list. Double-clicking on a command in the list issues
that command. To have a command act on items selected
in the host's directory list, use the quote placeholder
(which by default is "<>") to represent a selected
Last change: 12 May 1994 7
xftp(1) USER COMMANDS xftp(1)
item. For example, type "stage 1 <>" to send a STAGE
command to the the remote host for each selected item.
The quote placeholder can changed via the user prefer-
ences. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_-
_n_o_s_t_i_c_s, and _Q_u_o_t_e _P_l_a_c_e_h_o_l_d_e_r.)
Use Wildcard (in _S_e_l_e_c_t menus)
Pops up a dialog to prompt for a wildcard expression to
use in selecting entries in the host's current direc-
tory list. Previously referenced wildcard expressions
are cached and displayed in a scrolled list. Double-
clicking on an item in the list applies that wildcard
expression. Single-clicking on an item in the list
places the expression in a text field where it may be
edited. Choose the toggle item _R_e_p_l_a_c_e _F_i_l_e_n_a_m_e _S_e_l_e_c_-
_t_i_o_n to cause the currently selected entries to be
cleared before applying the wildcard. Choose the tog-
gle item _A_d_d _t_o _F_i_l_e_n_a_m_e _S_e_l_e_c_t_i_o_n to cause the entries
selected by the wildcard to be added to the current
selection. (See user preference _I_n_i_t_i_a_l _W_i_l_d_c_a_r_d
_M_o_d_e).
Using Help (in _H_e_l_p menu)
Gives a description of the online help package.
View (in _X_f_e_r _O_p_s controls)
Displays the selected file. The _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s
dialog (accessible via the _O_p_t_i_o_n_s menu) can be used to
control whether the file will be displayed using the
built-in viewer or using an external viewer of the
user's choice (e.g., _e_m_a_c_s or _x_v). The selection of
the viewer is configurable, based on the file extension
(e.g., ".gif" or ".jpg"). There is no limit on the
number or types of viewers that can be simultaneously
displayed.
The file is transferred according to the mode (_A_S_C_I_I or
_B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. A dialog pops up to
enable the user to monitor the progress of the
transfer. The dialog contains a button for aborting
the transfer.
The destination of the transfer is a temporary direc-
tory created in the directory defined as _P__t_m_p_d_i_r in
the include file stdio.h. If the environment variable
_T_M_P_D_I_R is defined, it is used as the directory. The
temporary directory, and the files it contains, are
automatically deleted when the user dismisses the
viewer or terminates _L_L_N_L _X_F_T_P.
If the file is recognized as being compressed, it is
expanded before viewing. _L_L_N_L _X_F_T_P excutes the
Last change: 12 May 1994 8
xftp(1) USER COMMANDS xftp(1)
following decompressors based on the file extension:
_g_u_n_z_i_p for ".z" and ".gz"; _u_n_c_o_m_p_r_e_s_s for ".Z"; _a_t_o_b
for "atob"; and _u_u_d_e_c_o_d_e for ".uu". _L_L_N_L _X_F_T_P searches
for the decompressor application in the standard way
using the _P_A_T_H environment variable.
Viewer Preferences (in _O_p_t_i_o_n_s menu)
Display the viewer preferences dialog. See _V_I_E_W_E_R
_P_R_E_F_E_R_E_N_C_E_S section for a description of viewer prefer-
ences.
USER PREFERENCES
Selecting item _P_r_e_f_e_r_e_n_c_e_s in the _O_p_t_i_o_n_s menu pops up a
dialog that allows the user to configure _L_L_N_L _X_F_T_P according
to his/her preferences. The user is presented with a number
of configuration parameters, which are set by either tog-
gling, sliding, or typing. Click the _A_p_p_l_y button to cause
the new values to take effect. The _O_K button has the same
effect as _A_p_p_l_y, but the dialog is also closed. The _C_a_n_c_e_l
button undoes changes made since _O_K or _A_p_p_l_y were last
pressed. The preferences can be preserved across _L_L_N_L _X_F_T_P
sessions in a text file named ".xftprc" in the user's home
directory. The user may alter the order the preferences are
presented in the dialog by (1) terminating _L_L_N_L _X_F_T_P, (2)
using a text editor to change the order of lines in
".xftprc" and (3) restarting _L_L_N_L _X_F_T_P.
Add To Cache
Specifies whether newly referenced items should be
added to the directory, quoted command, wildcard, and
host/user caches. It is usually desirable to choose
_Y_e_s. Choose _N_o if referencing a series of seldom-
referenced items that would clear the cache of your
favorite entries.
Anonymous Ftp Password
The value to initialize the "Password" field of the
_C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s dialog to. This is normally your
email address. The _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s dialog is
accessible via each host's _C_o_n_n_e_c_t menu.
Beep When Ops Done
Specifes whether to beep when each set of deletion,
move, quoted command, and file transfer operations com-
pletes.
Diagnostics
Specifies the level of diagnostics information to be
written to the diagnostics log window. Choose _Q_u_i_e_t
for error messages, only. Choose _N_o_r_m_a_l for error mes-
sages and success messages. Choose _V_e_r_b_o_s_e for error
messages, success messages, and replies received from
Last change: 12 May 1994 9
xftp(1) USER COMMANDS xftp(1)
the FTP servers. Choose _D_e_b_u_g for error messages, suc-
cess messages, commands sent to the FTP servers,
replies received from the FTP servers, and other
assorted diagnostics.
Directory Cache Size
The maximum number of previously referenced directory
paths cached per host. The cache is preserved across
_L_L_N_L _X_F_T_P sessions.
Enhance Colors
Speficies whether to "pretty up" some of the graphical
elements (such as scrolled lists and text fields) by
changing the normal background colors. This preference
has no effect on monochrome displays. Choose _Y_e_s to
enhance the appearance, or _N_o for the usual Motif look.
Enter Dir Upon Creation
Specifies whether to automatically enter a newly
created directory.
Host Cache Size
The maximum number of hosts to cache items for. The
cache is preserved across _L_L_N_L _X_F_T_P sessions.
Initial Logfile Name
The default file name to be presented to the user in
the "Save Log" dialog.
Initial Transfer Mode
The default file transfer mode (_A_S_C_I_I or _B_i_n_a_r_y).
Initial Wildcard Mode
The default mode of the "Use Wildcard" dialog. Choose
_R_e_p_l_a_c_e to make "Replace Filename Selection" the
default. Choose _A_d_d to make "Add to Filename Selec-
tion" the default.
Inquire On Copy
Specifies whether to pop up a dialog that asks the user
to confirm that the indicated transfers should take
place.
Inquire On Delete
Specifies whether to pop up a dialog that asks the user
to confirm that the indicated deletions should take
place.
Inquire On Move
Specifies whether to pop up a dialog that asks the user
to confirm that the indicated moves should take place.
Last change: 12 May 1994 10
xftp(1) USER COMMANDS xftp(1)
Inquire On Quote
Specifies whether to pop up a dialog that asks the user
to confirm that the indicated commands should be sent.
Left Auto Local Login
Specifies whether to automatically connect the left
side to the local (client) host upon starting _L_L_N_L
_X_F_T_P.
Max Ftp Retries
Specifies the maximum number of retries _L_L_N_L _X_F_T_P will
attempt if it receives a response from an FTP server
that indicates the desired operation failed because of
some temporary condition on the remote host.
Max Time For Ftp Reply
Specifies the maximum time in seconds that _L_L_N_L _X_F_T_P
will wait for a response from an FTP server before con-
cluding that the connection has been broken.
Preserve Vms Ver Nums
Specifies whether to preserve VMS file version numbers
when transferring files from a VMS system. This is
only an issue for those VMS FTP servers that provide
numbers (not all do).
Print Password In Debug
Specifies whether to print passwords in the log window
when the user preference _D_i_a_g_n_o_s_t_i_c_s is set to _D_e_b_u_g.
Quote Cache Size
The number of quoted commands to cache. The cache is
preserved across _L_L_N_L _X_F_T_P sessions.
Quote Placeholder
This is used as a placeholder in a quoted command to
represent items selected in the directory list. For
example, the quoted command "stage 1 <>" will send a
STAGE command to the remote host for each selected
item. The default value is "<>", but the placeholder
can be set to any nonnull printable string.
Recursive Delete Enabled
Specifies whether to enable the _R_e_c_u_r_s_i_v_e_l_y _D_e_l_e_t_e
_S_e_l_e_c_t_e_d _E_n_t_r_y(_s) item in the _O_p_s menus. Choose _N_o to
help prevent accidental recursive deletions.
Right Auto Local Login
Specifies whether to automatically connect the right
side to the local (client) host upon starting _L_L_N_L
_X_F_T_P.
Last change: 12 May 1994 11
xftp(1) USER COMMANDS xftp(1)
Sort Caches
Specifies whether to sort (by ASCII-collating sequence)
cached items when they are displayed in dialogs. If
_Y_e_s, then sort. If _N_o, then the most recently refer-
enced items are placed at the top of the list.
Sort Longs Lists By Date
Specifies whether to attempt to sort the "long" direc-
tory lists by time modified (with most recent listed
first) instead of by name. The _Y_e_s option is con-
sidered unsafe because some FTP servers to not support
this option and may give unpredictable results. (Most
UNIX hosts support this option.)
Store Unique
Specifies whether existing sink files are to be renamed
before file transfer occurs. If _Y_e_s then the existing
sink file is typically renamed by appending a "."
(period) followed by an integer between 1 and 99.
Symbols On Dir Entries
Specifies whether to append single characters to direc-
tory entries in order to distinguish their types. If
_Y_e_s(_U_n_s_a_f_e) is chosen, "/" is appended to directories,
"*" is appended to executables, "@" is appended to sym-
bolic links, and "=" is appended to AF_UNIX address
family sockets. The "Yes" option is considered to be
unsafe because some FTP servers do not support this
feature and may give unpredictable results. (Most UNIX
hosts support this option.) Furthermore, if you are
referencing a directory or directory entry whose name
ends with one of the special characters, you will need
to select _N_o(_S_a_f_e). When in doubt, select _N_o(_S_a_f_e).
One further note: use of this feature can dramatically
degrade interactivity.
Use Last Dir At Login
Specifies whether to automatically enter the most
recently referenced directory after connecting to a
host. If this option is requested, but is not possible
to perform (e.g., because the directory no longer
exists), an error message will be generated, and your
home directory will be entered. _N_o_t_e: This mechanism
attempts to enter the last directory referenced on the
host, regardless of whether it is another user's direc-
tory.
User Cache Size
The number of user names to cache (for remote hosts).
The cache is preserved across _L_L_N_L _X_F_T_P sessions.
Wildcard Cache Size
Last change: 12 May 1994 12
xftp(1) USER COMMANDS xftp(1)
The number of wildcard expressions to cache. The cache
is preserved across _L_L_N_L _X_F_T_P sessions.
VIEWER PREFERENCES
Selecting item _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s in the _O_p_t_i_o_n_s menu pops
up a dialog that allows the user to control which file will
be displayed with which viewer, based on the file extension.
A file to be viewed is first transferred to a temporary
directory and then, if necessary, is decompressed. The file
extension (e.g., ".gif") is then examined to determine which
viewer the file is to be displayed in. There are two types
of viewers: the viewer built into _L_L_N_L _X_F_T_P (which is suit-
able for displaying text files) and external viewers (e.g.,
_e_m_a_c_s for text and _x_v for graphics).
Single-click on an entry in the _E_x_t_e_n_s_i_o_n_s list to place
that extension and its associated command line into the
_E_x_t_e_n_s_i_o_n and _V_i_e_w_e_r _C_o_m_m_a_n_d _L_i_n_e text fields, respectively.
An extension is a file suffix that begins with a period
("."). A special entry in the extensions list, "OTHERS"
represents all files that do not have their extension listed
(including files with no extensions).
The pattern "<>" in a command line is a placeholder for the
name of the file to be viewed. A blank command line indi-
cates that the built-in viewer is to be used. To add a new
extension to the list, fill in the _E_x_t_e_n_s_i_o_n and _V_i_e_w_e_r _C_o_m_-
_m_a_n_d _L_i_n_e text fields and press the _A_d_d button. If the text
in _E_x_t_e_n_s_i_o_n does not begin with a period, one will be
added. If the extension is already in the list, it will be
replaced.
To replace the command line associated with an extension,
(1) single-click on the list item to select it, (2) edit the
command line, and (3) press the _R_e_p_l_a_c_e button.
To delete an extension from the list, single-click on the
list item to select it and then press the _D_e_l_e_t_e button.
The "OTHERS" entry cannot be deleted (but it's command line
can be replaced).
Click the _A_p_p_l_y button to cause the new changes to take
effect. The _O_K button has the same effect as _A_p_p_l_y, but the
dialog is also closed. The _C_a_n_c_e_l button undoes the changes
made since _O_K or _A_p_p_l_y were last pressed.
The viewer preferences can be preserved across _L_L_N_L _X_F_T_P
sessions in a text file named ".xftpview" in the user's home
directory (select _S_a_v_e _P_r_e_f_e_r_e_n_c_e_s in the main window's
_O_p_t_i_o_n_s menu).
Last change: 12 May 1994 13
xftp(1) USER COMMANDS xftp(1)
WIDGET HIERARCHY
Most of _L_L_N_L _X_F_T_P's widget heirarchy is listed here so that
the knowledgeable user can use the X resource mechanism to
customize _L_L_N_L _X_F_T_P. Widget names are followed by their
class names in parentheses. A question mark is displayed if
the widget's name is not known. _L_L_N_L _X_F_T_P's classname is
_X_F_t_p.
_M_a_i_n _W_i_n_d_o_w
main (XmMainWindow)
mainMenuBar (XmRowColumn)
File (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Edit (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Options (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Help (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
pane (XmPanedWindow)
topForm (XmForm)
leftHost (XmForm)
hostName (XmLabel)
hostMenuBar (XmRowColumn)
Connect (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Dir (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Select (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Ops (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
dirNameForm (XmForm)
dirName (XmRowColumn)
? (XmCascadeButtonGadget)
? (XmMenuShell)
dirNameMenu (XmRowColumn)
? (XmPushButtonGadget)
. . .
? (XmPushButtonGadget)
dirListSW (XmScrolledWindow)
dirList (XmList)
Last change: 12 May 1994 14
xftp(1) USER COMMANDS xftp(1)
rightHost (XmForm)
hostName (XmLabel)
hostMenuBar (XmRowColumn)
Connect (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Dir (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Select (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
Ops (XmCascadeButton)
? (XmMenuShell)
pulldown (XmRowColumn)
dirNameForm (XmForm)
dirName (XmRowColumn)
? (XmCascadeButtonGadget)
? (XmMenuShell)
dirNameMenu (XmRowColumn)
? (XmPushButtonGadget)
. . .
? (XmPushButtonGadget)
dirListSW (XmScrolledWindow)
dirList (XmList)
centerControls (XmForm)
xferModeFrame (XmFrame)
xferMode (XmRowColumn)
ascii (XmToggleButtonGadget)
xferModeLabel (XmLabel)
xferOpsFrame (XmFrame)
xferOps (XmRowColumn)
copyButton (XmPushButton)
rCopyButton (XmPushButton)
viewButton (XmPushButton)
xferOpsLabel (XmLabel)
logo (XmLabelGadget)
bottomForm (XmForm)
resultFlagFrame (XmFrame)
resultFlag (XmLabel)
logSW (XmScrolledWindow)
log (XmText)
_A_b_o_r_t _i_n _P_r_o_g_r_e_s_s _D_i_a_l_o_g
abort_popup (XmDialogShell)
abort (XmForm)
abortMessage (XmLabel)
_A_b_o_u_t _X_F_T_P _D_i_a_l_o_g
about_popup (XmDialogShell)
about (XmSelectionBox)
form (XmForm)
Last change: 12 May 1994 15
xftp(1) USER COMMANDS xftp(1)
frame (XmFrame)
startup (XmLabel)
_A_c_c_o_u_n_t _D_i_a_l_o_g
account_popup (XmDialogShell)
account (XmSelectionBox)
_C_h_a_n_g_e _D_i_r_e_c_t_o_r_y _D_i_a_l_o_g
changeDir_popup (XmDialogShell)
changeDir (XmSelectionBox)
_C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s _D_i_a_l_o_g
aConnect_popup (XmDialogShell)
aConnect (XmSelectionBox)
form (XmForm)
hostListLabel (XmLabel)
hostListSW (XmScrolledWindow)
hostList (XmList)
hostNameLabel (XmLabel)
hostName (XmTextField)
userNameLabel (XmLabel)
userName (XmTextField)
passwordLabel (XmLabel)
password (XmTextField)
_D_e_s_t_i_n_a_t_i_o_n _D_i_r_e_c_t_o_r_y _D_i_a_l_o_g
destdir_popup (XmDialogShell)
destdir (XmSelectionBox)
form (XmForm)
instruction (XmLabel)
dirNameForm (XmForm)
dirName (XmRowColumn)
? (XmCascaseButtonGadget)
? (XmMenuShell)
dirNameMenu (XmRowColumn)
? (XmPushButtonGadget)
. . .
? (XmPushButtonGadget)
dirListSw (XmScrolledWindow)
dirList (XmList)
_F_i_l_e _T_r_a_n_s_f_e_r _M_o_n_i_t_o_r _D_i_a_l_o_g
monitor_popup (XmDialogShell)
monitor (XmSelectionBox)
controlArea (XmForm)
nameLabel (XmLabel)
name (XmLabel)
lengthLabel (XmLabel)
length (XmLabel)
bytesMovedLabel (XmLabel)
bytesMove (XmLabel)
scale (XmScale)
Last change: 12 May 1994 16
xftp(1) USER COMMANDS xftp(1)
_H_e_l_p _D_i_a_l_o_g
help_popup (XmDialogShell)
help (XmForm)
pane (XmPanedWindow)
controlArea (XmForm)
topic (XmLabel)
textSW (XmScrolledWindow)
text (XmText)
_I_n_f_o_r_m_a_t_i_o_n _D_i_a_l_o_g
information_popup (XmDialogShell)
information (XmMessageBox)
_L_e_f_t _D_i_r_e_c_t_o_r_y _P_a_t_h _D_i_a_l_o_g
leftDirPath_popup (XmDialogShell)
leftDirPath (XmSelectionBox)
_L_e_f_t _L_o_n_g _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g
leftDirLong_popup (XmDialogShell)
leftDirLong (XmForm)
dirListSW (XmScrolledWindow)
dirList (XmText)
separator (XmSeparator)
closeButton (XmPushButton)
helpButton (XmPushButton)
_L_e_f_t _T_a_b_u_l_a_r _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g
leftDirTable_popup (XmDialogShell)
leftDirTable (XmForm)
scrolledWindow (XmScrolledWindow)
drawingArea (XmDrawingArea)
separator (XmSeparator)
closeButton (XmPushButton)
helpButton (XmPushButton)
_M_a_k_e _D_i_a_l_o_g
makeDir_popup (XmDialogShell)
makeDir (XmSelectionBox)
_M_o_n_i_t_o_r _D_i_a_l_o_g
mpMonitor_popup (XmDialogShell)
mpMonitor (XmSelectionBox)
form (XmForm)
pathLabel (XmLabel)
path (XmLabel)
_P_a_s_s_w_o_r_d _D_i_a_l_o_g
password_popup (XmDialogShell)
password (XmSelectionBox)
_P_r_e_f_e_r_e_n_c_e_s _D_i_a_l_o_g
prefs_popup (XmDialogShell)
Last change: 12 May 1994 17
xftp(1) USER COMMANDS xftp(1)
prefs (XmForm)
actionArea (XmForm)
okButton (XmPushButton)
separator (XmSeparator)
scrolledWindow (XmScrolledWindow)
rowColumn (XmRowColumn)
frame (XmFrame)
form (XmForm)
label (XmLabel)
--------------------------------------
textField (XmTextField)
--------------------------------------
radioBoxFrame (XmFrame)
radioBox (XmRowColumn)
? (XmToggleButtonGadget)
. . .
? (XmToggleButtonGadget)
--------------------------------------
scale (XmScale)
--------------------------------------
_Q_u_e_s_t_i_o_n _D_i_a_l_o_g
question_popup (XmDialogShell)
question (XmMessageBox)
_Q_u_o_t_e _D_i_a_l_o_g
quote_popup (XmDialogShell)
quote (XmSelectionBox)
form (XmForm)
listLabel (XmLabel)
listSW (XmScrolledWindow)
list (XmList)
textLabel (XmLabel)
text (XmTextField)
warningLabel (XmLabel)
warningFrame (XmFrame)
warning (XmRowColumn)
warningMsg1 (XmLabel)
warningMsg2 (XmLabel)
warningMsg3 (XmLabel)
_R_e_m_o_t_e _C_o_n_n_e_c_t _D_i_a_l_o_g
rConnect_popup (XmDialogShell)
rConnect (XmSelectionBox)
form (XmForm)
hostListLabel (XmLabel)
hostListSW (XmScrolledWindow)
hostList (XmList)
hostNameLabel (XmLabel)
hostName (XmTextField)
userNameLabel (XmLabel)
userName (XmTextField)
Last change: 12 May 1994 18
xftp(1) USER COMMANDS xftp(1)
_R_e_n_a_m_e _D_i_a_l_o_g
rename_popup (XmDialogShell)
rename (XmSelectionBox)
form (XmForm)
oldNameLabel (XmLabel)
oldName (XmLabel)
newNameLabel (XmLabel)
newName (XmTextField)
_R_i_g_h_t _D_i_r_e_c_t_o_r_y _P_a_t_h _D_i_a_l_o_g
rightDirPath_popup (XmDialogShell)
rightDirPath (XmSelectionBox)
_R_i_g_h_t _L_o_n_g _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g
rightDirLong_popup (XmDialogShell)
rightDirLong (XmForm)
dirListSW (XmScrolledWindow)
dirList (XmText)
separator (XmPushButton)
closeButton (XmPushButton)
helpButton (XmPushButton)
_R_i_g_h_t _T_a_b_u_l_a_r _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g
rightDirTable_popup (XmDialogShell)
rightDirTable (XmForm)
scrolledWindow (XmScrolledWindow)
drawingArea (XmDrawingArea)
separator (XmSeparator)
closeButton (XmPushButton)
helpButton (XmPushButton)
_S_a_v_e _D_i_a_g_n_o_s_t_i_c_s _L_o_g _D_i_a_l_o_g
saveLog_popup (XmDialogShell)
saveLog (XmSelectionBox)
_V_e_r_i_f_y _D_i_a_l_o_g
verify_popup (XmDialogShell)
verify (XmSelectionBox)
form (XmForm)
label (XmLabel)
listSW (XmScrolledWindow)
list (XmList)
_V_i_e_w _F_i_l_e _D_i_a_l_o_g
view_popup (XmDialogShell)
view (XmForm)
saveButton (XmPushButton)
closeButton (XmPushButton)
helpButton (XmPushButton)
separator (XmSeparator)
textSW (XmScrolledWindow)
text (XmText)
Last change: 12 May 1994 19
xftp(1) USER COMMANDS xftp(1)
_V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s _D_i_a_l_o_g
viewPrefs_popup (XmDialogShell)
viewPrefs (XmSelectionBox)
form (XmForm)
listLabel (XmLabel)
listSW (XmScrolledWindow)
list (XmList)
extensionLabel (XmLabel)
extension (XmTextField)
commandLineLabel (XmLabel)
commandLine (XmTextField)
editFrame (XmFrame)
editForm (XmForm)
addButton (XmPushButton)
replaceButton (XmPushButton)
deleteButton (XmPushButton)
messageFrame (XmFrame)
messageRowcolumn (XmRowColumn)
message1 (XmLabel)
message2 (XmLabel)
_W_i_l_d_c_a_r_d _D_i_a_l_o_g
wildcard_popup (XmDialogShell)
wildcard (XmSelectionBox)
form (XmForm)
listLabel (XmLabel)
listSW (XmScrolledWindow)
list (XmList)
textLabel (XmLabel)
text (XmTextField)
radioBoxFrame (XmFrame)
radioBox (XmRowColumn)
replaceToggle (XmToggleButtonGadget)
addToggle (XmToggleButtonGadget)
LIMITATIONS
Here are some things to watch out for:
_L_L_N_L _X_F_T_P might not work with some old X servers. For exam-
ple, some older OpenWindows servers might dump core. MacX
fans should use nothing older than version 1.1.7b.
Old, buggy versions of Motif can cause weirdness.
_L_L_N_L _X_F_T_P might not work correctly with some non-Unix FTP
servers. (If you can give us temporary access to such a
server, we might be able to fix the problem.)
Out-of-spec FTP servers can cause untold grief. (Most
Unix-based servers work correctly.)
Third-party file transfers will not work unless at least one
Last change: 12 May 1994 20
xftp(1) USER COMMANDS xftp(1)
of the remote FTP servers supports the PASV (passive) com-
mand.
FILES
$HOME/.xftpcache cache file
$HOME/.xftprc user preferences
$HOME/.xftpview viewer preferences
XFtp.color application defaults file for color displays
XFtp.mono application defaults file for monochrome displays
AVAILABILITY
The sources for _L_L_N_L _X_F_T_P are tarred and compressed, and are
available via anonymous ftp:
IP Address: phoenix.ocf.llnl.gov
Directory: /llnlxftp
SUPPORT
Because our resources are limited, we will not be able to
give individual assistance in building and using _L_L_N_L _X_F_T_P.
However, your comments, suggestions and bug reports are
valuable in helping us determine how to best direct our
efforts. Our email address is
llnlxftp@llnl.gov
COPYRIGHT
(c) 1993-1994. The Regents of the University of California.
All rights reserved.
This work was produced at the University of California,
Lawrence Livermore National Laboratory (UC LLNL) under con-
tract no. W-7405-ENG-48 (Contract 48) between the U.S.
Department of Energy (DOE) and The Regents of the University
of California (University) for the operation of UC LLNL.
Copyright is reserved to the University for purposes of con-
trolled dissemination, commercialization through formal
licensing, or other disposition under terms of Contract 48;
DOE policies, regulations and orders; and U.S. statutes.
The rights of the Federal Government are reserved under Con-
tract 48 subject to the restrictions agreed upon by the DOE
and University.
DISCLAIMER
This software was prepared as an account of work sponsored
by an agency of the United States Government. Neither the
United States Government nor the University of California
nor any of their employees, makes any warranty, express or
implied, or assumes any liability or responsibility for the
accuracy, completeness, or usefulness of any information,
Last change: 12 May 1994 21
xftp(1) USER COMMANDS xftp(1)
apparatus, product, or process disclosed, or represents that
its specific commercial products, process, or service by
trade name, trademark, manufacturer, or otherwise, does not
necessarily constitute or imply its endorsement, recommenda-
tion, or favoring by the United States Government or the
University of California. The views and opinions of the
authors expressed herein do not necessarily state or reflect
those of the United States Government or the University of
California, and shall not be used for advertising or product
endorsement purposes.
Permission to use, copy, modify and distribute this software
and its documentation for any non-commercial purpose,
without fee, is hereby granted, provided that the above
copyright notice and this permission notice appear in all
copies of the software and supporting documentation, and
that all UC LLNL identification in the user interface remain
unchanged. The title to copyright LLNL XFTP shall at all
times remain with The Regents of the University of Califor-
nia and users agree to preserve same. Users seeking the
right to make derivative works with LLNL XFTP for commercial
purposes may obtain a license from the Lawrence Livermore
National Laboratory's Technology Transfer Office, P.O. Box
808, L-795, Livermore, CA 94550.
SEE ALSO
ftpd(8C)
AUTHOR
Neale G. Smith, Lawrence Livermore National Laboratory
Last change: 12 May 1994 22